home *** CD-ROM | disk | FTP | other *** search
/ Linux Cubed Series 3: Developer Tools / Linux Cubed Series 3 - Developer Tools.iso / devel / lang / ada / gnat-3.05- / gnat-3 / gnat-3.05-i486-linux-elf-bin / rts / i-cpp.ads < prev    next >
Encoding:
Text File  |  1996-06-07  |  7.6 KB  |  172 lines
  1. ------------------------------------------------------------------------------
  2. --                                                                          --
  3. --                         GNAT RUNTIME COMPONENTS                          --
  4. --                                                                          --
  5. --                       I N T E R F A C E S . C P P                        --
  6. --                                                                          --
  7. --                                 S p e c                                  --
  8. --                                                                          --
  9. --                            $Revision: 1.8 $                              --
  10. --                                                                          --
  11. --   Copyright (C) 1992,1993,1994,1995,1996 Free Software Foundation, Inc.  --
  12. --                                                                          --
  13. -- GNAT is free software;  you can  redistribute it  and/or modify it under --
  14. -- terms of the  GNU General Public License as published  by the Free Soft- --
  15. -- ware  Foundation;  either version 2,  or (at your option) any later ver- --
  16. -- sion.  GNAT is distributed in the hope that it will be useful, but WITH- --
  17. -- OUT ANY WARRANTY;  without even the  implied warranty of MERCHANTABILITY --
  18. -- or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License --
  19. -- for  more details.  You should have  received  a copy of the GNU General --
  20. -- Public License  distributed with GNAT;  see file COPYING.  If not, write --
  21. -- to  the Free Software Foundation,  59 Temple Place - Suite 330,  Boston, --
  22. -- MA 02111-1307, USA.                                                      --
  23. --                                                                          --
  24. -- GNAT was originally developed  by the GNAT team at  New York University. --
  25. -- It is now maintained by Ada Core Technologies Inc (http://www.gnat.com). --
  26. --                                                                          --
  27. ------------------------------------------------------------------------------
  28.  
  29. --  Definitions for interfacing to C++ classes
  30.  
  31. with System;
  32. with System.Storage_Elements;
  33.  
  34. package Interfaces.CPP is
  35.  
  36.    package S   renames System;
  37.    package SSE renames System.Storage_Elements;
  38.  
  39.    --  This package corresponds to Ada.Tags but applied to tagged types
  40.    --  which are 'imported' from C++ and correspond to exactly to a C++
  41.    --  Class.  GNAT doesn't know about the structure od the C++ dispatch
  42.    --  table (Vtable) but always access it through the procedural interface
  43.    --  defined below, thus the implementation of this package (the body) can
  44.    --  be customized to another C++ compiler without any change in the
  45.    --  compiler code itself as long as this procedural interface is
  46.    --  respected. Note that Ada.Tags defines a very similar procedural
  47.    --  interface to the regular Ada Dispatch Table.
  48.  
  49.    type Vtable_Ptr is private;
  50.  
  51.    function Expanded_Name (T : Vtable_Ptr) return String;
  52.    function External_Tag  (T : Vtable_Ptr) return String;
  53.  
  54. private
  55.  
  56.    procedure CPP_Set_Prim_Op_Address
  57.      (T        : Vtable_Ptr;
  58.       Position : Positive;
  59.       Value    : S.Address);
  60.    --  Given a pointer to a dispatch Table (T) and a position in the
  61.    --  dispatch Table put the address of the virtual function in it
  62.    --  (used for overriding)
  63.  
  64.    function CPP_Get_Prim_Op_Address
  65.      (T        : Vtable_Ptr;
  66.       Position : Positive)
  67.       return     S.Address;
  68.    --  Given a pointer to a dispatch Table (T) and a position in the DT
  69.    --  this function returns the address of the virtual function stored
  70.    --  in it (used for dispatching calls)
  71.  
  72.    procedure CPP_Set_Inheritance_Depth
  73.      (T     : Vtable_Ptr;
  74.       Value : Natural);
  75.    --  Given a pointer to a dispatch Table, stores the value representing
  76.    --  the depth in the inheritance tree. Used during elaboration of the
  77.    --  tagged type.
  78.  
  79.    function CPP_Get_Inheritance_Depth (T : Vtable_Ptr) return Natural;
  80.    --  Given a pointer to a dispatch Table, retreives the value representing
  81.    --  the depth in the inheritance tree. Used for membership.
  82.  
  83.    procedure CPP_Set_TSD (T : Vtable_Ptr; Value : S.Address);
  84.    --  Given a pointer T to a dispatch Table, stores the address of the
  85.    --  record containing the Type Specific Data generated by GNAT
  86.  
  87.    function CPP_Get_TSD (T : Vtable_Ptr) return S.Address;
  88.    --  Given a pointer T to a dispatch Table, retreives the address of the
  89.    --  record containing the Type Specific Data generated by GNAT
  90.  
  91.    CPP_DT_Prologue_Size : constant SSE.Storage_Count :=
  92.                             SSE.Storage_Count
  93.                               (2 * (Standard'Address_Size / S.Storage_Unit));
  94.    --  Size of the first part of the dispatch table
  95.  
  96.    CPP_DT_Entry_Size : constant SSE.Storage_Count :=
  97.                          SSE.Storage_Count
  98.                            (2 * (Standard'Address_Size / S.Storage_Unit));
  99.    --  Size of each primitive operation entry in the Dispatch Table.
  100.  
  101.    CPP_TSD_Prologue_Size : constant SSE.Storage_Count :=
  102.                              SSE.Storage_Count
  103.                                (4 * (Standard'Address_Size / S.Storage_Unit));
  104.    --  Size of the first part of the type specific data
  105.  
  106.    CPP_TSD_Entry_Size : constant SSE.Storage_Count :=
  107.                           SSE.Storage_Count
  108.                             (Standard'Address_Size / S.Storage_Unit);
  109.    --  Size of each ancestor tag entry in the TSD
  110.  
  111.    procedure CPP_Inherit_DT
  112.     (Old_T       : Vtable_Ptr;
  113.      New_T       : Vtable_Ptr;
  114.      Entry_Count : Natural);
  115.    --  Entry point used to initialize the DT of a type knowing the
  116.    --  tag of the direct ancestor and the number of primitive ops that are
  117.    --  inherited (Entry_Count).
  118.  
  119.    procedure CPP_Inherit_TSD
  120.      (Old_TSD : S.Address;
  121.       New_Tag : Vtable_Ptr);
  122.    --  Entry point used to initialize the TSD of a type knowing the
  123.    --  TSD of the direct ancestor.
  124.  
  125.    function CPP_CW_Membership (Obj_Tag, Typ_Tag : Vtable_Ptr) return Boolean;
  126.    --  Given the tag of an object and the tag associated to a type, return
  127.    --  true if Obj is in Typ'Class.
  128.  
  129.    procedure CPP_Set_External_Tag (T : Vtable_Ptr; Value : S.Address);
  130.    --  set the address of the string containing the external tag
  131.    --  in the Dispatch table
  132.  
  133.    function CPP_Get_External_Tag (T : Vtable_Ptr) return S.Address;
  134.    --  retreive the address of a null terminated string containing
  135.    --  the external name
  136.  
  137.    procedure CPP_Set_Expanded_Name (T : Vtable_Ptr; Value : S.Address);
  138.    --  set the address of the string containing the expanded name
  139.    --  in the Dispatch table
  140.  
  141.    function CPP_Get_Expanded_Name (T : Vtable_Ptr) return S.Address;
  142.    --  retreive the address of a null terminated string containing
  143.    --  the expanded name
  144.  
  145.    function Displaced_This
  146.     (Current_This : S.Address;
  147.      Vptr         : Vtable_Ptr;
  148.      Position     : Positive)
  149.      return         S.Address;
  150.    --  Compute the displacement on the "this" pointer in order to be
  151.    --  compatible with MI.
  152.    --  (used for virtual function calls)
  153.  
  154.    type Vtable;
  155.    type Vtable_Ptr is access all Vtable;
  156.  
  157.    pragma Inline (CPP_Set_Prim_Op_Address);
  158.    pragma Inline (CPP_Get_Prim_Op_Address);
  159.    pragma Inline (CPP_Set_Inheritance_Depth);
  160.    pragma Inline (CPP_Get_Inheritance_Depth);
  161.    pragma Inline (CPP_Set_TSD);
  162.    pragma Inline (CPP_Get_TSD);
  163.    pragma Inline (CPP_Inherit_DT);
  164.    pragma Inline (CPP_CW_Membership);
  165.    pragma Inline (CPP_Set_External_Tag);
  166.    pragma Inline (CPP_Get_External_Tag);
  167.    pragma Inline (CPP_Set_Expanded_Name);
  168.    pragma Inline (CPP_Get_Expanded_Name);
  169.    pragma Inline (Displaced_This);
  170.  
  171. end Interfaces.CPP;
  172.